IBM Books

Access Integration Services Using and Configuring Features Version 3.3


Configuring and Monitoring the Differentiated Services Feature

This chapter describes the commands provided by the Differentiated Services (DiffServ) feature for configuring routers and interfaces to provide preferred service for selected data packets. It includes the following sections:


Accessing the Differentiated Services Configuration Prompt

To enter DiffServ configuration commands:

  1. Enter talk 6 at the OPCON (*) prompt.
  2. Enter feature ds at the Config> prompt.

The DS Config> prompt displays. You may now enter DiffServ configuration commands.


Differentiated Services Configuration Commands

These commands enable you to configure the DiffServ options, which designate preferred service for selected data packets. Table 47 summarizes the DiffServ configuration commands, and the rest of this section describes them in detail. Enter the commands at the DS Config> prompt. Either enter the command and options on one line, or enter only the command and then respond to the prompts. To see a list of valid command options, enter the command with a question mark instead of options.

Table 47. DiffServ Configuration Commands
Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Delete Deletes a DiffServ configuration record from a router's SRAM.
Disable Disables DiffServ either in a router or on a specific egress interface.
Enable Enables DiffServ either in a router or on a specific egress interface.
List Displays information about a router's DiffServ system and interface-related settings.
Set Specifies a router's DiffServ-related settings.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Delete

Use the delete command to delete a DiffServ system configuration record or interface record from a router's SRAM.

Syntax:  delete 
ds
interface

ds
Deletes the router's DiffServ system configuration record.

Example:

DS Config> delete ds
Diffserv system config record deleted
 
 

interface
Prompts you for the interface number to delete.

Example:

DS Config> delete interface
Enter Diffserv Interface number to delete [0]? 3
Diffserv interface config record deleted 
 
 

Disable

Use the disable command to disable the DiffServ function either in a router or on a specific egress interface.

Syntax:  disable 
ds
interface

ds
Disables the router's DiffServ function.

Example:

DS Config> disable ds
DiffServe feature disabled
 
 

interface
Prompts you for the number of the interface to disable.

Example:

DS Config> disable interface
Enter Interface number [0]? 2
DiffServe interface disabled
 
 

Enable

Use the enable command to enable the DiffServ function either in a router or on a specific egress interface.

Syntax:  enable 
ds
interface

ds
Enables the router's DiffServ function.

Example:

DS Config> enable ds
DiffServe feature enabled
 
 

interface
Prompts you for the number of the interface to enable.

Example:

DS Config> enable interface
Enter Interface number [0]? 2
DiffServe interface enabled
 
 
Note:DiffServ can be enabled only on PPP and Frame Relay links.

List

Use the list command to display information about a router's DiffServ system and interface-related settings.

Syntax:  list 
all
ds
interface

all
Displays information about a router's DiffServ and interface configurations.

ds
Displays a router's DiffServ configuration.

Example:

DS Config> list ds
 
System Parameters:
 
        DiffServ:                ENABLED
        Packet_size:             550
        Min BE Alloc (%):        10
        Min CTL Alloc (%):       5
        Number_of_Q:             2
 
 

interface
Displays the interfaces in a router, their DiffServ enable/disable status, and the parameters for each interface and queue.

Example:

DS Config> list interface
-------------------------------------------------------------------------------
                        ---------- Premium -------   --------- Assured --------
Net If     Status  NumQ Bwdth  Wght  OutBuf  MaxQos Bwdth  Wght  OutBuf  MaxQos
Num                       (%)   (%) (bytes)     (%)   (%)   (%) (bytes)     (%)
-------------------------------------------------------------------------------
2   PPP   Enabled     2    20    90    5500      95    80    10   27500      80
3   PPP   Enabled     2    20    90    5500      95    80    10   55000      80
 
 

Set

Use the set command to set a router's DiffServ system and interface-related parameters.

Syntax:   set 
be-alloc-min
ctl-alloc-min
interface
pkt-size

be-alloc-min
Specifies the minimum percentage of total output buffer space to allocate to best effort service.

Default value: 10

Example:

DS Config> set be-alloc-min
Enter Minimum percent output BW allocated to BE service (10 - 50) [10]?
 
 

ctl-alloc-min
Specifies the minimum percentage of total output buffer space to allocate to network control service.

Default value: 5

Example:

DS Config> set ctl-alloc-min
Enter Minimum percent output BW allocated to CTL service (5 - 20) [5]?
 
 

interface
Specifies the interface to enable for DiffServ and prompts you for interface-specific parameters.

Queue bandwidth
Specifies the percentage of the output link to be used for the premium queue. The remaining percentage is used for the assured queue value.

Default value: 20

Queue weight
Specifies the percentage of time that the scheduler monitors the premium queue. The remaining percentage is used for the assured queue value. The queue weight is defaulted to 90 percent so that the scheduler reacts quickly to EF traffic.

Default value: 90

Egress buffer size
Specifies the amount of data (in bytes) that can be queued on the premium queue and the assured queue.

For the premium queue, this parameter controls the amount of data (in bytes) that can be queued on the premium queue. Too large a value for this parameter could cause a high queuing delay for the premium traffic. For example, if this is set to 25 Kbytes and the output link speed is 1.5 Mbps (T1 speed), then there is a potential queuing delay of 133 msec (25000 bytes * 8 bits/byte)/1500000 bps, or .133 sec (133 milliseconds). Too small a value for this parameter could make it impossible to buffer small bursts. For example, if this is set to 2 Kb, it implies that there will not be sufficient buffering for a 2-packet burst of 1500-byte packets (because they require 3000 bytes of buffer space).

As a compromise between these two extremes, the default setting is 5500 bytes, which is ten times the default packet size of 550.

Default value: 5500 (premium queue)

For the assured queue, this parameter controls the amount of data (in bytes) that can be queued on the assured queue. The considerations for this parameter value are the same as for the premium queue, except that the traffic in the assured queue does not have very strict delay requirements. Rather, it is more likely that assured queue traffic will consist of TCP flows, which are bursty in nature. Because of this, enough buffer space must be defined to accommodate bursts from several flows.

A value of 27500, which is fifty times the default packet size of 550.

Default value: 27500 (assured queue)

Egress QoS allocation
Specifies the amount of the egress buffer size value (as a percentage) that all the DiffServ streams can reserve. The remaining percentage is used for the minimum size of the shared pool.

Default value: 95 (premium queue)

Default value: 80 (assured queue)

Example:

DS Config> set interface
Enter Diffserv Interface number [0]? 2
 
DiffServ Interface enabled
 
Set Premium Queue Bandwidth (%) (1 - 99) [20]?
    Assured Queue Bandwidth (%) = 80
 
Configure Advanced setting (y/n)? [No]: y
 
Set Premium Queue Weight (%) (20 - 99) [90]?
    Assured Queue Weight (%) = 10
 
EGRESS BufSize for Premium Queue (in bytes) (550 - 16500) [5500]?
Max EGRESS QoS Allocation for Premium Queue (%) (1 - 99) [95]?
 
EGRESS BufSize for Assured/BE Queue (in bytes) (5500 - 140800) [27500]?
Max EGRESS QoS Allocation for Assured/BE Queue (%) (1 - 99) [80]?
 
        DiffServ Interface: ENABLED
PREMIUM Queue Bandwidth (%) =                         20
PREMIUM Queue Weight (%) =                            80
PREMIUM Queue EGRESS BufSize in bytes =             5500
PREMIUM Queue Max EGRESS QoS allocation (%) =         95
ASSURED/BE Queue Bandwidth (%) =                      80
ASSURED/BE Queue Weight (%) =                         20
ASSURED/BE Queue EGRESS BufSize in bytes =         27500
ASSURED/BE Queue Max EGRESS QoS allocation (%) =      80
Accept input (y/n)? [Yes]:
 
 

pkt-size
Specifies the average packet size of the traffic flow (in bytes). This enables DiffServ to determine the available buffer space on the ingress and egress interfaces. If this is changed, the router must be restarted and the DiffServ set interface command values should be reviewed and changed if necessary.

Default value: 550

Example:

DS Config> set pkt-size
Average packet size (64 - 64000) [550]?
 
 

Accessing the Differentiated Services Monitoring Environment

The console portion of the DiffServ feature enables you to view and manage DiffServ-related settings. To access the DiffServ monitoring environment enter talk 5 at the OPCON prompt (*):

   * t 5

Then, enter the following command at the + prompt:

   + feature ds
   DS Console>
 
 

Differentiated Services Monitoring Commands

These commands enable you to view DiffServ-related settings. Table 48 summarizes the DiffServ monitoring commands and the rest of this section describes them. Enter the commands at the DS Console> prompt. Either enter the command and options on one line, or enter only the command and then respond to the prompts. To see a list of valid command options, enter the command with a question mark instead of options.

Table 48. DiffServ Monitoring Commands
Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
Clear Clears statistics for a stream between a specific ingress and egress interface pair.
DScache Clears or displays information in a router's DiffServ cache.
List Displays information about a router's DiffServ system and interface-related settings.
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Clear

Use the clear command to clear statistics for a stream between a specific ingress and egress interface pair.

Syntax:  clear 
stream-stats
Example:
DS Console> clear stream-stats
Incoming Network number : 0
Outgoing Network number : 2
IN Net 0 DiffServ not enabled.
Net 0->2 stream stats cleared at sysclock 85327 Second.
 
 

DScache

Use the dscache command to clear or display information in a router's DiffServ cache.

Syntax:  dscache 
actions
clear
nexthop
order
stats

actions
Displays the actions to be taken for packets sent from the specified IP source to the specified IP destination, and the DiffServ stream ID, if any.

Example:

DS Console> dscache actions
Source Address to list []?
Destination Address to list []?
Source          Destination     Pro ProtocolInf Net TosIn/Out Action StrmID
10.1.100.1      9.1.140.1         1 T:x08 C:x00   0 x00->x15  PASS   85
9.1.140.1       10.1.100.1        1 T:x00 C:x00   1 x00->x15  PASS   null
 
 

clear
Specifies clearing of the entire DiffServ cache.

nexthop
Displays the nexthop IP address.

Example:

DS Console> dscache nexthop
Source Address to list []? 5.0.13.248
Destination Address to list []? 5.0.11.249
Source          Destination     Pro ProtocolInf Net  Tos  NextHop
5.0.13.248      5.0.11.249       17  1031> 1031   0  x00  5.0.61.7      (PPP/1)
5.0.13.248      5.0.11.249       17  1032> 1032   0  x00  5.0.61.7      (PPP/1)
5.0.13.248      5.0.11.249       17  1033> 1033   0  x00  5.0.67.1      (PPP/1)
 
 

order
Displays the order in which the packets have arrived.

Example:

DS Console> dscache order
Order Source          Destination     Pro ProtocolInf Net  Tos
   1  5.0.16.246      5.0.13.248        1 T:x03 C:x03   2  x00
   2  5.0.13.248      5.0.16.246       17  4000> 5678   0  x00
   3  5.0.16.246      5.0.13.244        1 T:x03 C:x03   1  x00
   4  5.0.13.248      5.0.15.243       17   123>  123   0  x00
 
 

stats
Displays statistics for packets sent from the specified IP source to the specified IP destination.

Example:

DS Console> dscache stats
Source Address to list []? 5.0.13.248
Destination Address to list []? 5.0.11.249
Source          Destination     Pro ProtocolInf Net  Tos    RxPkts    RxBytes
5.0.13.248      5.0.11.249       17  1031> 1031   0  x00       432     444096
5.0.13.248      5.0.11.249       17  1032> 1032   0  x00       432     444096
5.0.13.248      5.0.11.249       17  1033> 1033   0  x00       437     459516
 
 

List

Use the list command to display information about a router's DiffServ system and interface-related settings.

Syntax:  list 
interface
queue
stream
vifs

interface
Lists the interfaces in a router, their DiffServ enable/disable status, their ingress buffer allocations, and other information.

Net
Displays the interface number.

Status
Displays the DiffServ status.

KB/s
Displays the link speed in Kb per second.

VirtTime
Displays the virtual time used by the scheduler (indicates n/a for non DiffServ links, indicates 0 if no packets are in progress).

InMax
Displays the maximum buffer size configured for assured forwarding.

InCurr
Displays the amount of buffer space currently being used for the input stream. The buffers contain packets in progress.

InShar
Displays the amount of shared buffer space available for this egress interface.

InMaxA
Displays the maximum amount of buffer space that can be allocated to all QoS streams in aggregate.

InCurA
Displays the amount of allocated buffer space available for use by the input stream.

NumI
Displays the number of input streams.

NumO
Displays the number of output streams.

Example:

DS Console> list interface
DiffServ interfaces:
Net Status   KB/s  VirtTime InMax  InCurr InShar InMaxA InCurA NumI NumO
--- -------- ----- -------- ------ ------ ------ ------ ------ ---- ----
  0 Disabled  1250      n/a  55000    550  49775  44000   5225   22  n/a
  1 Disabled  1250      n/a  27500      0  27500  22000      0   20  n/a
  2 Enabled    256        0  27500      0  27500  22000      0   20    3
  3 Enabled    256        0  55000      0  55000  44000      0   20    3
  4 Disabled     0      n/a 550000      0 550000 550000      0   20  n/a
  5 Disabled     0      n/a 550000      0 550000 550000      0   20  n/a
  6 Disabled     0      n/a 550000      0 550000 550000      0   20  n/a
  7 Disabled     0      n/a 550000      0 550000 550000      0   20  n/a
  8 Disabled  2000      n/a  27500      0  27500  22000      0   20  n/a
  9 Disabled     0      n/a 550000      0 550000 550000      0   20  n/a
 
 

queue
Displays the weights assigned to the DiffServ egress queues, and the buffer allocation status of the egress interfaces.

Queued packets
Displays the number of packets currently queued (0 indicates that no packets are currently queued).

Svc Tag
Displays the next virtual time that this queue should receive service.

Weight
Displays the scheduler weight of this queue.

out_max_alloc
Displays the maximum amount of buffer space that can be allocated to a DiffServ stream.

out_curr_alloc
Displays the current amount of buffer space allocated.

out_max_buff
Displays the maximum amount of buffer space for this queue.

out_curr_buff
Displays the amount of currently allocated buffer space being used for packets.

out_share_buff
Displays the amount of buffer space currently in the shared pool.

Example:

DS Console> list queue
OUT Network number : 1
 
Premium Queue:
        Queued packets: 0
        Svc Tag:        4294967295
        Weight: 20
        out_max_alloc:  5225 (Bytes)
        out_curr_alloc: 0 (Bytes)
        out_max_buff:   5500 (Bytes)
        out_curr_buff:  0 (Bytes)
        out_share_buff: 5500 (Bytes)
 
 
Assured Queue:
        Queued packets: 0
        Svc Tag:        4294967295
        Weight: 80
        out_max_alloc:  22000 (Bytes)
        out_curr_alloc: 4125 (Bytes)
        out_max_buff:   27500 (Bytes)
        out_curr_buff:  0 (Bytes)
        out_share_buff: 23375 (Bytes)
 
 

stream
Displays information about streams.

Id
Stream identification number

t
Stream type

D
DiffServ stream

B
Best effort stream

C
Network control stream

R
RSVP stream

I/o q
Queue type

q1
Premium queue

q2
Assured/BE queue

allo/cur(K)
Total buffer space (in kilobytes) allocated by this stream.

tot pkt
Total packets received for transmission by this stream.

tot Kby
Total kilobytes received for transmission by this stream.

pkt snt
Total packets sent by this stream.

Kby snt
Total kilobytes sent by this stream.

ovr snt
Number of packets sent using shared buffers.

buf drp
Number of packets dropped from this stream because no buffer space was available.

policed
Number of packets dropped by the policer on the premium queue.

Example:

DS Console> list stream
Incoming Network number : 0
Outgoing Network number : 2
At interface 0, 22 in-streams; clock=904 sec.
Streams from net 0 to net 2:
 Id   t I/o q  allo/cur(K)  tot pkt  tot Kby  pkt snt  Kby snt  ovr snt  buf drp policed
 ---- - -----  -----------  -------  -------  -------  -------  -------  ------- -------
(policy name)
 85   D   in    5.2/   0.0    82384    43828    48653    25883        0        0
         o-q1   5.2/   1.1                      48653    25883        0        0     732
 
(-)
 55   B   in    0.0/   0.0        0        0        0        0        0        0
         o-q2   2.8/   0.0                        263       21        0        0       0
 
(-)
 44   C   in    0.0/   0.0        0        0        0        0        0        0
         o-q2   1.4/   0.0                         79        6        0        0       0
 
 

vifs
Displays information about Frame Relay virtual interfaces.

Example:

DS Console> list vifs 1
 
DiffServ virtual interface for dlci:  17
     Status: Inactive - no packets queued for transmission
     CIR: 64000 (bits/sec)
     Virtual Time: 0
     Service Tag:  0
 
DiffServ virtual interface for dlci:  16
     Status: Inactive - no packets queued for transmission
     CIR: 64000 (bits/sec)
     Virtual Time: 0  
     Service Tag:  0
 
 


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]